home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 47 / Amiga Format AFCD47 (Issue 131, Xmas 1999).iso / -serious- / misc / gatewaytools / doku / g5-tools.dok < prev    next >
Text File  |  1999-10-04  |  12KB  |  310 lines
  1. Eine kleine Sammlung von Tools, die für das Gateway-BBS-System
  2. geschrieben wurden und im CLI laufen.
  3.  
  4. Dieses Archiv ist Freeware, jeder kann es nutzen wie er möchte.
  5. Ausgenommen ist jedoch jede kommerzielle Nutzung. Verbreitung nur
  6. wenn das Archiv unverändert im Originalzustand weiter gegeben wird.
  7. AmiNet, AmiNet-CD und Fred Fish bzw. die AmigaLib haben das das Recht
  8. zur Veröffentlichung (incl. CD-Rom's).
  9.  
  10. Anmerkung PPC/WOS: Nur in Einzelfällen verfügbar Aufgrund eines
  11. Problems mit meinem System. Was fertig und GETESTET ist wird jeweils
  12. in späteren Versionen vorhanden sein.
  13. =====================================================================
  14.  
  15. Warum Kommandos, die es schon so oft gibt?
  16. ------------------------------------------
  17.  
  18. Weil diese Versionen Funktionserweiterungen haben, die es eben sonst
  19. nicht gibt oder gab. Außerdem war Gateway bisher kommerziell so das
  20. einige Programme nicht von mir eingesetzt werden durften. So wurden
  21. diese Tools geschrieben. Von vielen der Tools gibt es auch keine
  22. deutschen Versionen. Lediglich der Copybefehl ist eine Ausnahme,
  23. er wurde für einen Sysop adaptiert der kein englisch spricht.
  24.  
  25. Versionsnummern bedeuten: VERSION.REVISION.x (x=Buildcounter)
  26. Bei jeder Änderung wird die REVISION erhöht und Build auf 0 gesetzt.
  27. Solange die Version + Revision identisch sind ist es auch das Pro-
  28. gramm, selbst wenn BUILD verändert ist. Dieser Zähler besagt nur das
  29. eine neue Übersetzung der Quellen stattgefunden hat und ist für mich
  30. zur Kontrolle wichtig.
  31.  
  32. =====================================================================
  33. du:                V 5.3.x                           Status: FREEWARE
  34. ---
  35.  
  36. Unix-Like Diskusage-Befehl.
  37. Benutzung: Du [ drive | pfad ]
  38. Zeigt das Verzeichnis mi allen Unterzeichnissen und ermittelt die
  39. Belegung in Blöcken.
  40.  
  41. Besonderheiten:
  42. ---------------
  43. - Link's werden erkannt, Größe wird korrekt berechnet.
  44. - Größe der Plattenblöcke wird ermittelt so das die
  45.   Berechnung der Header stimmt (was oft nicht passiert).
  46. - Anzeige formatiert mit Dezimalpunkten.
  47.  
  48. Benötigt:
  49. ---------
  50. - gateway.library (Library liegt bei, Doku und Developer-Kit
  51.                    sind als Paket veröffentlicht).
  52.  
  53. =====================================================================
  54. Echo:              V 5.3.x                           Status: FREEWARE
  55. -----
  56.  
  57. printf-Like Echo-Befehl.
  58.  
  59. Echo -? = Build-In-Hilfe.
  60. Echo -h = Header-Information.
  61. Echo -e = Erweitert die aktuelle Zeile (ohne zuvor NewLine durchzu-
  62.           führen).
  63.  
  64. Innerhalb der Ausgaben von Echo können (wie im printf spezielle
  65. Steuerungen benutzt werden. Sie beginnen immer mit \ gefolgt von
  66. einem oder mehreren Zeichen. Um \ als Zeichen auszugeben muß \\
  67. benutzt werden.
  68.  
  69. \n        = NewLine = Ascii 10
  70. \r        = Return  = Ascii 13
  71. \t        = Tab     = Ascii  9
  72. \xFF      = Hexwert FF als Ascii-Zeichen anzeigen
  73. \0###     = Octalwert ### als Ascii-Zeichen anzeigen
  74. \e        = Escape
  75. \E        = CSI ( Esc + [ )
  76. \l        = Ctrl-L (FormFeed, bewirkt im CLI einen Clear-Screen)
  77. \^A - \^Z = Ctrl-A bis Ctrl-Z
  78. \"        = Hochkomme " anzeigen und nicht als Textende auswerten
  79.  
  80. Alle CLI-Ersetzungen des Standard-Echo-Befehle (*N, *E, etc.) bleiben
  81. unberührt, das heißt der CLI wird sie ausführen, sofern er aktiv ist.
  82.  
  83. =====================================================================
  84. Head:              V 5.6.x                           Status: FREEWARE
  85. -----
  86.  
  87. Dateiheader (die ersten 10 Zeilen von Dateien anzeigen).
  88.  
  89. Aufruf:
  90. -------
  91. Head <datei> [<zweite Datei> [<dritte Datei> ...]]
  92.  
  93. Einzeldateiangabe: Nur die 10 Headerzeilen anzeigen
  94. Multidateianzeige: Alle Dateihader voneinander trennen.
  95.  
  96. =====================================================================
  97. Tail:              V 5.9.x                           Status: FREEWARE
  98. -----
  99.  
  100. Dateiende (gewünschte Anzahl Zeilen anzeigen).
  101.  
  102. Aufruf:
  103. -------
  104. Tail <datei> [ TO <ausgabe> ] [ LIN <zeilen> ]
  105.  
  106. Datei ist die Datei deren Ende angezeigt werden soll.
  107. Wird TO mit Dateinamen angegeben, dann wird die Ausgabe nicht nach
  108. stdout sondern in diese Datei geschrieben.
  109. Mit LIN kann die gewünschte Zeilenzahl eingestell werden. Standard
  110. ist 10.
  111.  
  112. Falls jemandem das Format bekannt vorkommt, es gibt irgendwo auf den
  113. Fish-Disketten einen Tail mit identischer Syntax. Dieser wurde ganz
  114. am Anfang von Gateway-III eingesetzt. Solange, bis es zu GURU's
  115. kam. Das Problem waren zu große Dateien. Nach einem kurzen Check
  116. der verfügbaren Alternativen (nicht funktionsfähig, ebenfalls
  117. begrenzte Datengrößen, nicht frei nutzbar etc.) wurde dieser sehr
  118. schnelle Ersatz geschrieben. Um weniger Arbeit zu haben und bei den
  119. vorhandenen Mailboxen keine Update-Probleme zu bekommen wurde die
  120. Syntax des alten PD-Programmes übernommen.
  121.  
  122. =====================================================================
  123. wc:                V 1.1.x                           Status: FREEWARE
  124. ---
  125.  
  126. Noch ein WordCount.
  127.  
  128. Aufruf:
  129. -------
  130. wc <patternstring>
  131.  
  132. Dieser wc kann Patternmatching (#, ?, *, (), ~ und ')
  133. Anzeige ist formatiert, hat Dezimalpunkte in der Ausgabe und
  134. arbeitet (eingeschränkt) mit Match-Pattern. Erklärungen der
  135. Datenfelder in der Ausgabe.
  136.  
  137. Benötigt:
  138. ---------
  139. - gateway.library (Library liegt bei, Doku und Developer-Kit
  140.                    sind als Paket veröffentlicht).
  141.  
  142. Known Bugs:
  143. -----------
  144. Der Aufruf 'wc Drive:Pfad/Datei#?' oder 'wc Pfad/Datei#?'
  145. funktioniert teilweise nicht richtig. Im aktuellen Verzeichnis ist
  146. 'wc Datei#?' jedoch korrekt. Das 'WildPatternMatching' muß debugged
  147. werden. Sorry, aber ich bin noch nicht dazu gekommen.
  148.  
  149. =====================================================================
  150. GKonvert:          V 5.14.x                          Status: FREEWARE
  151. ---------
  152.  
  153. Gateway Konverter
  154.  
  155. Aufruf:
  156. -------
  157. GKonvert [-r <InFile>] [-w <OutFile>] ([-u] | [-i] | [-s] | [-@])
  158.          [-$] [-l] [-a] [-x]
  159.          [-m <Zeilen>] [-e] [-!]
  160.  
  161. -r <InFile>  = Angabe, wie das Quellfile lautet.
  162. -w <OutFile> = Angabe, wie das Zielfile lautet.
  163. -u           = Umlaute von IBM nach AMIGA konvertieren.
  164. -U           = wie vor, jedoch zusätzlich Strg-/Ctrl-Z entfernen.
  165. -i           = Umlaute von AMIGA nach IBM konvertieren.
  166. -s           = Umlaute simulieren (ae, oe usw.).
  167. -@           = Umlaute in HTML-Standard umwandeln.
  168. -$           = EURO-Symbol entsprechend Umlauten wandeln.
  169. -l           = Zeilenkonvertierung nach IBM-Norm.
  170. -a           = ANSI-Filter aktivieren.
  171. -x           = Rechte Leerzeichen abschneiden.
  172. -m <Zeilen>  = Maximale Anzahl Zeilen.
  173. -e           = Datei <OutFile>_COLOR für Ansi-Editor (-a muß gesetzt sein).
  174. -!           = G-5-Steuerzeichen filtern (Updatefunktionen)
  175.  
  176.  
  177. Benötigt:
  178. ---------
  179. - gateway.library (Library liegt bei, Doku und Developer-Kit
  180.                    sind als Paket veröffentlicht).
  181.  
  182. Hinweise:
  183. ---------
  184. Dies ist ein Tool dessen Funktionen zum Teil nur in Verbindung mit
  185. einer Gateway-5-BBS Sinn machen.
  186. Ich habe es deshalb mit aufgenommen weil es in der Lage ist, eine
  187. HTML-Seite die auf dem Amiga erstellt wurde mit Umlauten zu versehen,
  188. die von jedem Browser erkannt werden. Wer schon mal eine HTML-Seite
  189. dahingehend von Hand nachbearbeitet hat der weiß was ich meine. Und
  190. wenn EUROPA schon eine Einheit wird, dann muß wenigstens der EURO
  191. (Kurzform: EUR) aus der Reihe tanzen? Oder warum sonst geht Billy
  192. wieder eigene Wege? Macht nichts:
  193. Amiga <-> IBM wird beidseitig direkt konvertiert.
  194. IBM oder AMIGA --> SIMU für zu 'EUR'.
  195. IBM oder AMIGA --> HTML für auch zu 'EUR'.
  196.  
  197. =====================================================================
  198. CheckCPU:          V 1.2.x                           Status: FREEWARE
  199. ---------
  200.  
  201. Aufruf:
  202. -------
  203. CheckCPU [?] [-h] [-f]
  204.  
  205.  ? : Copyright
  206. -h : Kurzhilfe
  207. -f : Fehler unterdrücken (Library nicht vorhanden)
  208.      Für Systeme die keine MMU oder keinen PPC haben
  209.  
  210.  
  211. Zeigt einen Ansi-Vorspann, dann CPU/FPU, MMU und einige der
  212. wichtigsten Adressen der MMU, danach alle installierten
  213. PPC-CPU's mit CPU-Typ, Revision und Clock (Mhz).
  214.  
  215. Der Ansi-Aufbau ist für Mailboxen (sieht auch im CLI ganz gut aus).
  216.  
  217. Als Vorlage zur Erstellung waren die Programme CheckMMU (aus dem
  218. Thor-MMU-Archiv) und PPCInfo (Phase-5 PPC-Release) eine sehr
  219. aufschlußreiche Informationsquelle.
  220.  
  221. Eigentlich wollte ich den Source beilegen, aber ich habe es aus zwei
  222. Gründen gelassen.
  223. 1.) Der Source ist mit den Gateway-5-Standard-Includes übersetzt,
  224.     was ein extrem lange Include-Kette bedeutet die über die
  225.     einzelnen Programmierbereiche verteilt ist. Hinzu kommt das
  226.     ich eine gigantische Link-Lib benutze die über 50% meiner
  227.     BBS-Software enthält.
  228.  
  229. 2.) Ich habe die unangenehme Angewohnheit ohne Kommentare zu
  230.     programmieren. Falls jemand nicht weiß, wie er sowas hinbekommt
  231.     sind meine Sourcen wohl nicht sehr hilfreich, aber ich sende den
  232.     Kernsource ggf. gerne zu. (Kernsource: das komplette Programm
  233.     aber die Includes nur soweit sie beim Programm direkt liegen).
  234.     Zur Übersetzung müßten dann einige .h-Files angepasst werden.
  235.  
  236. Benötigt:
  237. ---------
  238. Die mmu.library (V0.5) um MMU's anzuzeigen.
  239. Die ppc.library um PPC-Prozessoren mit aufzulisten.
  240. ppc.library: (c) Phase-5, wird mit den PPC-Boards ausgeliefert.
  241. mmu.library: (c) Thor, the mmu.lib development group.
  242.  
  243. Hinweis:
  244. --------
  245. Falls jemand hier noch nie die CPU des Amiga's ermittelt hat und das
  246. jetzt erstmalig versucht: Die Original-Include's von Commodore
  247. <exec/execbase.h> hören beim 68040-Prozessor auf. Von Phase5 gibt es
  248. eine Anleitung, was in der .h-Datei und den ASM-Includes angepasst
  249. werden muß, damit diese auch 68060 unterstützen (zu finden im
  250. AmiNet).
  251.  
  252. Hinweis:
  253. --------
  254. Entsprechend der MMU-Doku von Thor sollen auch höhere Library-
  255. Versionen abgefangen werden (ich nehme an das such die Struktur
  256. hier nochmal ändert). Aus diesem Grund wird nur Version 0.5 zuge-
  257. lassen.
  258. Der Befehl Version, im CLI gestartet, benennt diese Lib fälschlich
  259. mit Version 0.05!
  260.  
  261. ToDo:
  262. -----
  263. Ein Schalter der ANSI abschaltet.
  264.  
  265. =====================================================================
  266. Copy:              V 1.2.x                           Status: FREEWARE
  267. -----
  268.  
  269. Ursprünglicher Autor SDI, im Oktober 1998 von mir adaptiert, da vom
  270. Autor seit Dez. 97 keine Updates mehr erschienen sind und ich davon
  271. ausgehe, das er nichts mehr daran macht.
  272.  
  273. Copyright's: SDI ist Copyrightinhaber, (das bleibt unangetastet).
  274. Der Source lag in einem anderen Paket das unter anderem die Freeware-
  275. include-Files von SDI enthielt. Es fehlen Originaldoku's, falls es
  276. die überhaupt gibt.
  277.  
  278. Aufruf:
  279. -------
  280. Wie Original-Copy!
  281. Hilfe intern mit COPY ? und auf dem dann angezeigten Eingabefeld
  282. nochmal ? tippen für eine deutsche Doku zur Befehlsmaske.
  283.  
  284. Änderungen:
  285. -----------
  286. Interne Hilfe in deutsch (in den neuen Bundesländern gibt es
  287. nunmal recht viele Leute die kein englisch können).
  288. Einige Änderngen für vbcc (angemahnte bzw. unsaubere Pointer-
  289. assignments und Ptr/Int-Konflikte).
  290. Unterstützung der CPU's (auf 68040/060 ist das ein merklicher
  291. Unterschied), Version für PPC und WOS erzeugt.
  292.  
  293. Ist voll kompatibel zum Originalcopy aus C: und kann diesen
  294. ersetzen. Kann DELETE, MOVE und mehr ebenfalls ersetzen. Wer
  295. dieses möchte sollte folgende Alias-Kommandos (Shell-Startup)
  296. verwenden:
  297.  
  298. Alias MOVE "Copy MOVE CLONE "
  299. Alias DELETE "Copy DELETE "
  300.  
  301. ====================================================================
  302. Crc      - CRC32-Check
  303. GKonvert - Konverter Amiga<->IBM
  304. GSort    - Sort-Programm mit Sort ab Offset
  305.  
  306. haben eigene Doku's, diese liegen bei. Copyright's die die Nutzung
  307. außerhalb der Gateway-BBS-Software ausschliessen brauchen nicht be-
  308. achtet werden, die Doku's wurden direkt aus meiner BBS-Dokumentation
  309. entnommen.
  310.